Back to Contents Previous Next
1. Misc
FNwimp_initialise(name$,wimpmem%,ver%,desktopsave%)
This function registers your application with the Task Manager, reserves some important memory and determines if the application will
give a response to the Wimp’s ‘desktop save’ protocol and whether it will pass on unused messages from the Wimp’s messaging system.
Returns Wimp-assigned task handle.
name$ = the name of your application eg. ‘MyApp’.
wimpmem% = number of bytes to reserve for window, icon and menu definitions. (Space for indirected data is allocated automatically.)
ver% = minimum version of RISC OS that the application is allowed to run on, multiplied by 100. (Needs to be at least 360 to use all Dr Wimp’s facilities.)
If desktopsave% <> 0 then application will respond to Wimp’s ‘desktop save’ message.
FNwimp_OStolength(osvalue,scale,inch%)
Converts OS units to mm or inches.
osvalue = OS value to convert, can be integer or floating point.
scale = scaling factor 0-100 (%) can be integer or floating point.
If inch%=0 the value returned is in mm. If inch%=1 the
value returned is in inches.
FNwimp_lengthtoOS(length,scale,inch%)
Converts a length in mm or inches to OS units.
length = value to convert, can be integer or floating point.
scale = scaling factor 0-100 (%) can be integer or floating point.
If inch%=0 the length value supplied is in mm. If inch%=1
the length value supplied is in inches.
FNwimp_getdaydatetime(choice%)
Returns current day/date/time as a string.
If choice%=0, string format is “Mon 06 Jun 2005 15:09:37”
If choice%=1 (day only) string format is “Mon”
If choice%=2 (date only) string format is “06 Jun 2005”
If choice%=3 (time only) string format is “15:09:37”
For each choice the string length/format is always the same as shown.
FNwimp_changecase(string$,upper%)
Converts a string all to upper or lower case characters.
string$ = string to convert
If upper% = 0 then conversion is to lower case
If upper% = 1 then conversion is to upper case
(The conversion only affects the alphabetical characters A-Z and a-z.
All others are left unchanged.)
PROCwimp_error(title$,error$,from%,spritename$,spritearea%,button%,-altbutton$)
Reports an error using an error box with only one action button.
title$ = title of error window. (If title$=”” then the title will be the application name.)
error$ = error message.
If from%=0 then title has no prefix
If from% = 1 then the title is prefixed by ‘Error from ’.
If from% = 2 then the title is prefixed by ‘Message from ’.
spritename$ is name of a user-chosen sprite to be added to error box.
spritearea% is spritearea of above sprite: 1 meaning the wimp-pool.
If button%=1 then the single button will be called ‘Continue’.
If button%=2 then the single button will be called ‘Cancel’.
altbutton$ contains, if required, a user-chosen name for the single button. If it is not a null string it will be used irrespective of the button% value.
(See Section 2.8 for details.)
FNwimp_errorchoice(title$,error$,from%,type%,spritename$,spritearea-%,continue%,cancel%,extrabutton$)
Reports an error using an error box with 1 or more action buttons, returning the number of button pressed.
title$ = title of error window. (If title$=”” then the title will be the application name.)
error$ = error message.
If from%=0 then title has no prefix
If from% = 1 then the title is prefixed by ‘Error from ’.
If from% = 2 then the title is prefixed by ‘Message from ’.
If type%=1 then the error box will have an ‘information’ icon.
If type%=2 then the error box will have an ‘error’ icon.
If type%=3 then the error box will have a ‘program’ icon.
If type%=4 then the error box will have a ‘question’ icon.
spritename$ is name of a user-chosen sprite to be added to error box.
spritearea% is spritearea of above sprite: 1 meaning the wimp-pool.
If continue%=1 then the error box will have a ‘Continue’ button.
If cancel%=1 then the error box will have a ‘Cancel’ button.
extrabutton$ allows the error box to have extra/alternative buttons. It should be a null-string if no extra/alternative buttons required, or a comma-separated list of the required button text(s).
Returns the number of the pressed button: 1 is ‘Continue’ (if present); 2 is ‘Cancel’ (if present); 3, 4, 5 etc. is one of the other buttons in their order in extrabutton$.
(See Section 2.8 for details.)
FNwimp_testobjectpresent(path$,warning%)
Checks whether a Filer object is present and returns, as a string, its file type.
path$ - full path of object which may be a directory, application or file.
For a file, the return is normally of the form “XXX”, where &XXX is the filetype. Leading zeros will be added as necessary to bring the return string up to three characters. (But, exceptionally, an untyped file will return the string “-1”)
For a directory, the return is “1000”
For an application, the return is “2000”
If the object is not found the return is a null string.
If warning% is not 0, then a warning will be given if the object is not present. There are no ‘fatal’ errors.
FNwimp_countdirectoryobjects(dir$)
Returns number of objects (i.e. files/applications/directories) in
specified directory.
dir$ - full pathname of directory or application
Returns -1 if object not found.
FNwimp_getdirectoryobjectname(dir$,objectnumber%)
Returns name (as it appears in Filer window) of a specified object (identified by number) in specified directory.
dir$ - full pathname of directory or application
objectnumber% is 1 for first object, 2 for second object, etc.
Objects are read in alphabetical order of name - so names starting
with ! (Ascii 33) will come first.
Returns a null string if object not found.
(Use ‘FNwimp_countdirectoryobjects’ first to find total number of objects present in directory.)
FNwimp_getdirectoryobjecttype(dir$,objectnumber%)
Returns, as a string, the filetype number of specified object (identified by number) in specified directory. A file will
return upper-case “XXX” where “XXX” is the filetype hex number e.g. “FFF” for textfiles - or “0AF” for filetype &af.
A directory will return “1000” and an application “2000”.
dir$ - full pathname of directory or application
objectnumber% is 1 for first object, 2 for second object, etc.
Objects are read in alphabetical order of name - so names starting
with ! (Ascii 33) will come first.
Returns a null string if object not found.
(Use ‘FNwimp_countdirectoryobjects’ first to find total number of objects present in directory.)
FNwimp_getdirectorypath(pathname$)
Returns the pathname with the leafname removed i.e. returns the directory specification string. The trailing fullstop (or trailing colon, if pathname$ is something like “Boot:!Help”) will be included.
Does not check that removed leafname is actually a file i.e it could be a directory or application.
pathname$ = pathname string.
(If pathname$ does not include at least one “.” or “:” character a null-string will be returned i.e. no leafname is present.)
FNwimp_getleafname(path$)
Returns a string containing the leafname from the pathname.
Does not check that leafname is actually a file i.e it could be a directory or application.
path$ = pathname string.
(If there is no “.” or “:” character in path$, then path$ is returned unaltered i.e. path$ was already a leafname.)
PROCwimp_createdirectory(dir$,warning%)
Creates a new, empty directory.
dir$ - full path of required new directory.
If warning% is not 0, then a warning will be given if the directory into which the new directory is to be placed is not present - and if dir$ already exists as a file. There are no ‘fatal’ errors.
PROCwimp_setfiletypenumber(filepath$,filetype%,warning%)
Sets the filetype of the specified file, using a file-type number.
filepath$ - full pathname of file.
filetype% - required filetype as a number in the range 0-&FFF. If value is outside this range, the file will be given the &FFF filetype i.e. Text.
warning% - if not 0, a warning will be given if the object does not exist or is a directory/application
PROCwimp_setfiletypehexstring(filepath$,filetype$,warning%)
Sets the filetype of the specified file, using a file-type hex string.
filepath$ - full pathname of file.
filetype$ - required filetype as a hex string e.g. “&FFF” or just “FFF”. If value is outside the hex range 0-&FFF, the file will be given the &FFF filetype i.e. Text.
warning% - if not 0, a warning will be given if the object does not exist or is a directory/application
FNwimp_getobjecttypenumber(path$,warning%)
Returns - as a number - the file-type of a named Filer object
path$ - full path of object which may be a directory, application or file.
For a file, the return is a number in the range 0-4095 (-1 for an un-typed file). The return is 4096 (&1000) for a directory and 8192 (&2000) for an application.
If the object is not found the return is 0 (Note that there is a potential conflict here if the file-type is 0 - which is a very unlikely occurrence.)
If warning% is not 0, then a warning will be given if the object is not present. There are no ‘fatal’ errors.
FNwimp_getobjecttypehexstring(path$,warning%)
Returns - as a string - the file-type of a named Filer object.
THIS FUNCTION IS IDENTICAL TO FNwimp_testobjectpresent() and is copied under this different name for user convenience.
path$ - full path of object which may be a directory, application or file.
For a file, the return is normally of the form “XXX”, where &XXX is the filetype. Leading zeros will be added as necessary to bring the return string up to three characters. (But, exceptionally, an untyped file will return the string “-1”)
For a directory, the return is “1000”
For an application, the return is “2000”
If the object is not found the return is a null string.
If warning% is not 0, then a warning will be given if the object is not present. There are no ‘fatal’ errors.
FNwimp_copyobject(sourcepath$,destinationpath$,deletesource%,new-er%,restamp%,force%,warning%)
Copies/moves directory objects (recursively as necessary) - with options. Returns 0 if action fails for any reason, otherwise returns 1.
sourcepath$ - full pathname of object to be copied/moved. (Can be wildcarded.)
destinationpath$ - full pathname of destination. (Leafname can be wildcarded.)
deletesource% - if not 0, copied object will be deleted after copying i.e. the object is moved.
newer% - if not 0, overwriting an existing object will only occur if source object is newer.
restamp% - if not 0, copied objects will be given new time-stamp.
force% - if not 0, objects will be copied/moved irrespective of any access locks etc.
warning% - if not 0, a warning will be given if the source object does not exist. There are no ‘fatal’ errors.
FNwimp_deleteobject(path$,force%,warning%)
Deletes a named Filer object (recursively as necessary) - with options.
Returns 0 if action fails for any reason, otherwise returns 1.
path$ - full pathname of object to be deleted. (Can be wildcarded.)
force% - if not 0, objects will be deleted irrespective of any access locks etc.
warning% - if not 0, a warning will be given if the object does not exist. There are no ‘fatal’ errors.
FNwimp_renameobject(existingpath$,newpath$,warning%)
Renames a named Filer object.
Returns 0 if action fails for any reason, otherwise returns 1.
existingpath$ - full path of existing object.
newpath$ - required full path of renamed object.
If warning% is not 0, then a warning will be given if the existing object does not exist, or if directory into which the renamed object is to be placed is not present, or if newpath$ already exists as a file. There are no ‘fatal’ errors.
PROCwimp_doubleclickobject(path$,warning%)
Has same effect as ‘double-clicking’ on a Filer object i.e. an application will be run; a file will be loaded into its ‘parent’ application (if the latter has been ‘seen’) and a directory will be opened to show ite contents.
path$ = full pathname of object.
warning% - if not 0, a warning will be given if the object does not exist.
PROCwimp_opendirectory(dir$,default%,topx%,topy%,width%,height%,i-consize%,sortby%,warning%)
Opens the Filer window for the specified directory.
dir$ is the full directory path (any trailing dot is ignored).
If default% is not 0 the window opens centred on the screen and with the current default Filer window attributes.
If default% is 0 then the window opens using the values in the following six parameters.
topx%, topy% position of top left corner of window in screen OS units.
width%, height% initial visible size of window in OS units.
If size%=1 the Filer icons will be small.
If size%=2 the Filer icons will be large.
If size%=3 the Filer icons will be small with full information.
If sortby%=1 the icons will be sorted by name.
If sortby%=2 the icons will be sorted by file-type.
If sortby%=3 the icons will be sorted by date.
If sortby%=4 the icons will be sorted by size.
If warning% is not 0 a non-fatal warning will be given if dir$ cannot be found.
PROCwimp_closedirectory(dir$)
Close the Filer window for the specified directory.
dir$ is the full directory path (any trailing dot is ignored).
PROCwimp_sendfiletoprinter(filepath$,delete%)
Sends the named file directly to the currently configured printer.
Has same effect as dragging the file to the printer icon on the iconbar.
filepath$ = full pathname of file.
If delete% is not 0, the file will be deleted after being sent to the printer.
(Also listed under Section 3.12 Printing)
FNwimp_getscreenres(direction%)
Returns the resolution (number of pixels) of the current screen mode
in the specified direction.
If direction%=0 then return is horizontal resolution.
If direction%=1 then return is vertical resolution.
FNwimp_getscreensize(side%)
Returns the required dimension, in OS units, of the full screen in
current mode.
If side% = 0 returns width.
If side% = 1 returns height.
FNwimp_worktoscreen(window%,coord%,side%)
Converts the x or y work area coordinate coord% to an x or y screen
coordinate - in OS units
window% = handle of window whose work area coordinate is being converted.
coord% = coordinate (x or y).
If side% = 0 then coord% is a x coordinate, and an x coordinate is returned.
If side% = 1 then coord% is a y coordinate, and a y coordinate is returned.
FNwimp_screentowork(window%,coord%,side%)
Converts the x or y screen coordinate coord% to a work area x or y coordinate - all in OS units.
window% = handle of window whose work area coordinate is being sought.
coord% = coordinate (x or y).
If side% = 0 then coord% is a x coordinate, and an x coordinate is returned.
If side% = 1 then coord% is a y coordinate, and a y coordinate is returned.
FNwimp_libversion
Returns the version number (×100) of the DrWimp library.
Eg. if the version of the library is 3.61 then 361 will be returned.
FNwimp_osversion
Returns the RISCOS version number (×100) of the machine being used.
Eg. if the RISC OS version is 4.02 then 402 will be returned.
PROCwimp_setsysvariable(sysvar$,val$)
Sets the ‘value’ of a system variable.
sysvar$ - name of system variable.
val$ - ‘value’ to be set - in string form.
PROCwimp_unsetsysvariable(sysvar$)
Unsets (deletes) a system variable.
sysvar$ - name of system variable (case sensitive).
FNwimp_getsysvariable(sysvar$)
Returns, as a string, the contents of the system variable sysvar$.
Note ‘<’ and ‘>’ are not required in sysvar$.
sysvar$ is case-sensitive.
If designated system variable is not present a null string is returned.
FNwimp_testsysvariable(sysvar$)
Returns TRUE (-1) if designated system variable is present, or FALSE (0) if not.
Note ‘<’ and ‘>’ are not required in sysvar$.
sysvar$ is case-sensitive.
(Note difference from usual Dr Wimp practice of returning 1 or 0)
FNwimp_decplacesnum(number,decplaces%)
Returns, as a real number, the number formatted to the designated
number of decimal places.
number - is the number to format, can be integer or floating point.
decplaces% - is the number of decimal places required.
Rounding is ‘to the nearest’ i.e. to two decimal places, 1.635 becomes 1.64 and, for negative numbers, -1.635 becomes -1.64
(N.B. this function can suffer from rounding errors. Use the string
version ‘FNwimp_decplacesstr’ if possible.)
FNwimp_decplacesstr(number,decplaces%)
Returns, as a string, the number formatted to the designated number of
decimal places.
number - is the number to format, can be integer or floating point.
decplaces% - is the number of decimal places required.
Rounding is ‘to the nearest’ i.e. to two decimal places, 1.635 becomes 1.64 and, for negative numbers, -1.635 becomes -1.64
FNwimp_roundfloat(float)
Rounds the specified floating point number up or down and returns the
integer.
FNwimp_numtodecstring(number%)
Converts a number in any format to an unsigned decimal integer in string form. The output range is “0” to “4294967295” and there are no leading zeros added.
number%= number to convert.
FNwimp_numtosigneddecstring(number%)
Converts a number in any format to a signed decimal integer in string form. The output range is “-2147483648” to “2147483647” and there are no leading zeros added.
number%= number to convert.
FNwimp_numtohexstring(number%,digits%,prefix%)
Converts a number in any format to a hex value in string form.
The output range (i.e. number of hex characters) is determined by the value of digits%, as below.
number%= number to convert.
If digits%=1, output range is “0” to “F”
If digits%=2, output range is “00” to “FF”
If digits%=4, output range is “0000” to “FFFF”
If digits%=6, output range is “000000” to “FFFFFF”
If digits%=8, output range is “00000000” to “FFFFFFFF”
(If digits% is set to <1 then digits% will be reset to 1. If digits% is set to >8 then digits% will be reset to 8. If digits% is set to 3, 5 or 7 then digits% will be reset to 4, 6 or 8, respectively.)
For each value of digits% leading zeros are added to keep the result at the shown constant string length.
If prefix% is not 0 the output string is prefixed with the extra character “&”.
If number% is greater than the maximum value possible for the chosen value of digits% only those bytes needed to do the conversion are used i.e. the least significant bytes of number%.
FNwimp_numtobinstring(number%,digits%,prefix%)
Converts a number in any format to a binary value in string form.
The output range (i.e. number of ‘bits’) is determined by the value of digits%, as below.
number%= number to convert.
If digits%=1, output range is “00000000” to “11111111” i.e. 1×8 ‘bits’.
If digits%=2, output range is 2×8 = 16 ‘bits’.
If digits%=3, output range is 3×8 = 24 ‘bits’.
If digits%=4, output range is 4×8 = 32 ‘bits’.
(If digits% is set to <1 then digits% will be reset to 1. If digits% is set to >4 then digits% will be reset to 4.)
For each value of digits% leading zeros are added to keep the result at the shown constant string length.
If prefix% is not 0 the output string is prefixed with the extra character “%”.
If number% is greater than the maximum value possible for the chosen value of digits% only those bytes needed to do the conversion are used i.e. the least significant bytes of number%
PROCwimp_hourglassoff
Turns off the hourglass.
PROCwimp_hourglasson
Turns on the hourglass.
PROCwimp_hourglasspercentage(percentage%)
Sets the percentage display on the hourglass. (If there are nested PROCwimp_hourglasson calls in operation when this call is made then the percentage value can only be further changed from the same nesting level.)
percentage% needs to be in the range 0 to 99. If the value is outside that range the percentage display is switched off.
PROCwimp_bar(window%,icon%,length%,dir%)
Sets/adjusts the length of a bar - in OS units.
window% = handle of window containing the bar.
icon% = icon number of the bar.
length% = length of the bar in OS units.
If dir% = 0 then the bar moves horizontally keeping the height constant.
If dir% = 1 then the bar moves vertically keeping the width constant.
PROCwimp_increaseslot(bytes%)
Increases size of wimpslot by bytes% bytes. If not
enough available RAM then creates an error.
PROCwimp_quit(type%)
Used to initiate quitting action and also to re-start a wimp shutdown that has been temporarily stopped.
If type%=0 an ‘application quit’ will be initiated.
If type%=1 a temporarily halted ‘shutdown’ will be re-started.
In both cases, FNuser_quit() will be called with type% passed to it.
(See Section 2.27 of Manual for details.)
PROCwimp_pause(seconds)
Introduces a pause into the processing.
seconds = required pause, in seconds. Can be any real positive value.
PROCwimp_setcolour(red%,green%,blue%,background%)
Sets the current GCOL colour (for foreground or background) to the nearest possible for the current mode.
red% = amount of red in range 0-255.
green% = amount of green in range 0-255.
blue% = amount of blue in range 0-255.
If background%=0 then the foreground colour will be set, otherwise the background colour will be set.
(Best used immediately before corresponding plotting/printing action - see Section 2.33 ‘Graphics colours’.)
FNwimp_istaskrunning(taskname$)
Checks whether a task (i.e. an application, module etc.) is already running on the Wimp and returns TRUE or FALSE accordingly.
taskname$ is the name of the task - which must be exactly the same as that used by the task in the Task Display.
(For an application the task name is often, but not always, the application name without the leading “!”. For an application authored using Dr Wimp, the name of the task will be the the string passed in the first parameter of the FNwimp_initialise call.)
PROCwimp_starttask(command$)
Sends command$ to the CLI. Omit ‘*’.
FNwimp_measurefile(filepath$,warning%)
Returns the size in bytes needed to store a file in memory prior to using FNwimp_loadfile(), FNwimp_loaddfile(), FNwimp_loadsprites() or FNwimp_loadjpegfile().
Returns -1 if filepath$ not found.
Always use this as opposed to any other form of measurement.
filepath$ = full pathname of spritefile.
warning% - if not 0, a non-fatal warning will be given if filepath$ cannot be found.
(This function is also listed in in other sections)
FNwimp_loadfile(filepath$,handle%,warning%)
General file loader. Loads a file into a block of memory at handle%.
Returns address (handle) at which to load the next file (if any) into the same memory block. (If filepath$ cannot be found the return will be the value of handle% i.e. memory not used.)
filepath$ = full pathname of file.
warning% - if not 0, a non-fatal warning will be given if filepath$ cannot be found.
Memory must have been created after using FNwimp_measurefile to find necessary size.
(Not to be used for spritefiles/drawfiles/JPEGfiles which have their own equivalent wimp-functions.)
PROCwimp_savefile(savepath$,filehandle%,ftype%)
General file saver. Saves a file stored in a memory block into a normal Filer file. (Not to be used for sprites.)
(File in block must have been loaded using FNwimp_loadfile).
filehandle% = handle of stored file to save.
savepath$ = full pathname to save to.
ftype%=filetype required - as hex number e.g. &fff for textfile.
FNwimp_createstringblock(items%,length%,da%)
Creates a block for storing strings in. Returns a handle
to the block. (Load/read block using PROCwimp_putinstringblock and FNwimp_getfromstringblock only.)
items% = maximum number of strings to store.
length% = maximum possible length of each string.
da%=0 means create the block with DIM, otherwise create as a dynamic area.
PROCwimp_putinstringblock(block%,string$,pos%.error%)
Stores a string in a block. (The block must have been created using FNwimp_createstringblock).
block% = handle of block.
string$ = string to store.
pos% = position to store string in (ranging from 1 to maximum number of strings as passed to FNwimp_createstringblock).
error% determines action taken if pos% is outside valid range - see Manual Section 2.33
(Strings stored in this way can be read with FNwimp_getfromstringblock)
FNwimp_getfromstringblock(block%,pos%,error%)
Returns a string stored in a block by PROCwimp_putinstringblock.
block% = handle of block.
pos% = position of string in block (ranging from 1 to
maximum as passed to FNwimp_createblock).
error% determines action taken if pos% is outside valid range - see Manual Section 2.33
PROCwimp_setstringblock(block%,string$)
Sets all elements of a string block (created with FNwimp_createstringblock) to the same string value.
block% = handle of block.
string$ = string to put into each element.
FNwimp_createintegerblock(items%,da%)
Creates a block for storing integers in. Returns a handle
to the block. (Load/read block using PROCwimp_putinintegerblock and FNwimp_getfromintegerblock only.)
items% = maximum number of integers to store.
da%=0 means create the block with DIM, otherwise create as a dynamic area.
PROCwimp_putinintegerblock(block%,integer%,pos%.error%)
Stores an integer in a block. (The block must have been created using FNwimp_createintegerblock).
block% = handle of block.
integer% = integer to store.
pos% = position to store integer in (ranging from 1 to maximum number of integers as passed to FNwimp_createintegerblock).
error% determines action taken if pos% is outside valid range - see Manual Section 2.33
(Integers stored in this way can be read with FNwimp_getfromintegerblock)
FNwimp_getfromintegerblock(block%,pos%,error%)
Returns a integer stored in a block by PROCwimp_putinintegerblock.
block% = handle of block.
pos% = position of integer in block (ranging from 1 to
maximum as passed to FNwimp_createblock).
error% determines action taken if pos% is outside valid range - see Manual Section 2.33
PROCwimp_setintegerblock(block%,integer%)
Sets all elements of an integer block (created with FNwimp_createintegerblock) to the same integer value.
block% = handle of block.
integer% = integer value to put into each element.
PROCwimp_plotwindowline(window%,point1x%,point1y%,point2x%,poi-nt2y%,type%)
Plots a straight line within a window. (Intended to be used within PROCuser_redraw)
window%=handle of window to plot in.
point1x%, point1y% = work area OS coordinates of one end of required line.
point2x%, point2y% = work area OS coordinates of the other end.
If type% = 0 then a full line is drawn.
If type%= 1 then a dotted line is drawn.
PROCwimp_plotwindowrectangle(window%,bottomleftx%,bottomlefty%,-width%,height%,fill%)
Plots a rectangle within a window. (Intended to be used within PROCuser_redraw)
window%=handle of window to plot in.
bottomleftx%, bottomlefty% = work area OS coordinates of bottomleft corner of required rectangle.
width%, height% = width and height of rectangle in OS units.
If fill% = 1 then rectangle is filled.
If fill%= 0 then rectangle is an outline only.
PROCwimp_plotwindowcircle(window%,centrex%,centrey%,radius%,fill-%)
Plots a circle within a window. (Intended to be used within PROCuser_redraw)
window%=handle of window to plot in.
centrex%, centrey% = work area OS coordinates of centre of required circle.
radius% = radius of circle in OS units.
If fill% = 1 then circle is filled.
If fill%= 0 then circle is an outline only.
PROCwimp_plotwindowellipse(window%,centrex%,centrey%,semimajor-%,semiminor%,rotatedegrees,fill%)
Plots an ellipse within a window. (Intended to be used within PROCuser_redraw)
window%=handle of window to plot in.
centrex%, centrey% = work area OS coordinates of centre of required ellipse.
semimajor% = half-length of major axis in OS units.
semiminor% = half-length of minor axis in OS units.
rotatedegrees = angle of rotation of ellipse about its centre, in degrees.
If fill% = 1 then ellipse is filled.
If fill%= 0 then ellipse is an outline only.
PROCwimp_plotwindowtriangle(window%,point1x%,point1y%,point2x%-,point2y%,point3x%,point3y%,fill%)
Plots a triangle within a window. (Intended to be used within PROCuser_redraw)
window%=handle of window to plot in.
point1x%, point1y% etc. = work area OS coordinates of the three vertices of the required triangle.
If fill% = 1 then triangle is filled.
If fill%= 0 then triangle is an outline only.
FNwimp_getfreeRAM
Returns the number of bytes of free RAM available.
PROCwimp_startuserdragbox()
NOT IN DrWimp LIBRARY.
ONLY USED AS PART OF ‘Elixir_04’ for user-defined drag-boxes - see Manual Section 2.36 and 3.16.
Starts dragging of user-defined drag-box. (Intended to be used within PROCuser_mouseclick().)
Top of page Back to Contents Previous Next